Skip to main content

로그 백업 및 아카이브 파일 관리

로그 백업 및 아카이브 파일 저장 및 관리

목적

  • 로그를 주기적으로 백업하여 아카이브 파일로 저장하고, 아카이브 파일의 개수를 제한함으로써 저장 공간을 효율적으로 관리한다.

선행 조건

  • 관리센터에 접속할 수 있는 권한이 있어야 한다.
  • 백업 시스템이 설정된 주기에 따라 자동으로 동작해야 한다.

주요 흐름

  1. 설정 페이지로 이동
    • 관리자는 설정 메뉴를 클릭하여 설정 페이지로 이동한다.
  2. 로그 백업 설정 기능 활성화 (옵션)
    • 관리자는 로그 백업 설정 기능을 활성화한다.
  3. 로그 백업 설정
    • 관리자가 표준 시간대를 설정한다.
    • 로그 백업 주기를 설정한다. (일자와 시간)
    • 로그 아카이브 파일에 저장될 로그 데이터의 기간을 설정한다.
    • 저장될 아카이브 파일의 최대 개수를 설정한다.
  4. 설정 저장
    • 관리자는 설정을 저장한다.
  5. 백업 실행
    • 시스템은 설정된 주기와 시간대에 따라 백업 작업을 자동으로 실행한다.
  6. 로그 아카이브 파일 생성
    • 백업 작업이 실행되는 날짜를 기준으로, 백업 전날부터 선택한 기간 동안의 로그를 포함한 아카이브 파일이 생성된다.
  7. 최대 개수 초과 시 파일 삭제
    • 저장된 아카이브 파일의 개수를 확인한다.
    • 최대 개수를 초과하는 경우, 가장 오래된 아카이브 파일부터 순차적으로 삭제하여 최대 개수를 유지한다.
  8. 아카이브 파일 다운로드
    • 설정 메뉴에서 관리자는 저장된 아카이브 파일을 다운로드할 수 있다.

필요 기능

  • 로그 백업 설정 기능 (옵션)
    • 로그 백업 설정 기능의 사용 여부를 선택할 수 있다.
    • 사용함으로 선택 시 세부 기능을 설정할 수 있다.
  • 로그 백업 기능
    • 자신의 표준 시간대(UTC)를 선택할 수 있다.
      • 옵션값: UTC+09:00 서울 등
      • 디폴트값: UTC+09:00 서울
    • 백업 주기를 일자와 시간으로 설정할 수 있다.
      • 일자: 텍스트 입력(숫자만 입력 가능)
        • 최대 입력 가능 일수: 365일
      • 시간: 드롭박스 선택
    • 선택한 표준 시간대를 기준으로 설정한 주기에 따라 백업 작업을 자동으로 실행한다.
      • 백업 주기 시작: 설정을 저장한 시점 이후 설정된 시간에 도달하면 첫 번째 백업이 실행된다.
      • 반복 실행: 첫 번째 백업 이후, 설정된 일수와 시간에 따라 주기적으로 백업이 반복 실행된다.
        • 예시 시나리오:
          • 예시 1
            • 현재 시간: 9월 30일 오후 1시(13:00) 백업 주기 설정: 이틀마다 오전 6시(06:00)
            • 첫 번째 실행 시간: 10월 1일 오전 6시
            • 이후 실행: 10월 2일 오전 6시, 10월 4일 오전 6시 …
          • 예시 2
            • 현재 시간: 9월 30일 오후 1시(13:00) 백업 주기 설정: 이틀마다 오후 3시(15:00)
            • 첫 번째 실행 시간: 9월 30일 오후 3시
            • 이후 실행: 10월 2일 오후 3시, 10월 4일 오후 3시 …
    • 로그 백업 주기 변경 시 동작 방식
      • 백업 주기 변경 후, 새로운 주기에 따라 다음 백업이 실행되며, 이때 설정된 로그 수집 기간에 따라 로그가 수집됩니다.
        • 시나리오 예시:
          • 초기 설정: 20일 주기 백업
          • 15일 경과 후 설정 변경: 10일 주기 백업으로 수정
          • 다음 백업 실행: 설정 변경 후 10일 후
          • 로그 수집: 백업 시점 기준으로 설정된 로그 수집 기간만큼의 로그
        • 구체적 날짜 예시 (로그 수집 기간을 30일로 가정):
          • 2024년 10월 1일: 초기 설정 (20일 주기)
          • 2024년 10월 16일: 백업 주기 변경 (10일 주기로 수정)
          • 2024년 10월 26일: 다음 백업 실행
            • 로그 수집 기간: 2024년 9월 26일 - 2024년 10월 25일 (30일간)
  • 로그 수집 기간 설정 기능
    • 아카이브 파일에 저장될 로그 데이터의 기간을 일자로 입력할 수 있다.
      • 최대 입력 가능 일수: 365일(숫자만 입력 가능)
      • 로그 수집 기간은 백업이 실행되는 날을 기준으로 계산된다.
        • 백업 실행일 전날부터 선택한 기간동안의 로그가 아카이브 파일에 저장된다.
          • 예시: 관리자가 최근 "30일" 을 입력한 경우
            • 백업 작업 날짜: 2023년 8월 15일 오후 2시
            • 파일에 포함되는 로그: 2023년 7월 16일부터 2023년 8월 14일까지의 로그가 아카이브 파일로 저장된다.
            • 설명: 백업 실행일(8월 15일)을 제외하고 그 전 30일 동안의 로그가 저장된다.
  • 최대 파일 개수 설정 기능
    • 저장될 아카이브 파일의 최대 개수를 입력할 수 있다.
    • 최대 입력 가능 개수: 50개(숫자만 입력 가능)
  • 로그 아카이브 파일 생성 기능
    • 파일 내 로그 데이터: 백업 작업이 실행되는 날짜를 기준으로, 백업 전날부터 선택한 기간 동안의 로그가 아카이브 파일에 저장된다.
    • 파일 생성 시점: 백업 작업이 실행되는 시점에 아카이브 파일을 생성한다.
    • 파일 형식: 로그를 하나의 CSV 형식의 아카이브 파일로 생성하고, ZIP 파일로 압축하여 제공한다.
      • CSV 내 데이터는 쉼표(,)로 구분한다.
      • 예시: 설정된 백업 주기에 따라 설정된 기간 동안의 로그를 CSV 파일로 생성하고, 이 파일을 ZIP 파일로 압축한다.
    • 파일명 형식: log_archive_YYYYMMDD_YYYYMMDD.zip
      • log_archive: 고정된 접두사로, 파일이 로그 아카이브임을 나타낸다.
      • YYYYMMDD_YYYYMMDD: 파일에 포함된 로그의 시작 날짜와 종료 날짜를 나타낸다. 예: 2023년 7월 1일부터 2023년 7월 31일까지의 로그 데이터를 포함하는 파일의 이름-> log_archive_20230701_20230731.zip
      • ZIP 파일 내부 파일명: log_archive_YYYYMMDD_YYYYMMDD.csv
  • 아카이브 파일 삭제 기능
    • 저장된 아카이브 파일의 개수를 확인하고, 최대 개수를 초과하는 경우 오래된 파일부터 삭제한다.
      • 예시: 최대 개수가 10개로 설정된 경우, 11번째 파일이 생성되면 가장 오래된 파일을 삭제한다.
  • 아카이브 파일 다운로드 기능
    • 저장된 아카이브 파일을 다운로드할 수 있다.
    • 필드값: 번호, 파일명, 생성일, 다운로드
      • 생성일: 아카이브 파일이 생성된 일자
    • 다운로드 버튼 클릭 시 zip 파일 다운로드가 가능하다.

예외 케이스

  • 파일 다운로드 실패
    • 시스템 오류로 인해 파일 다운로드에 실패한 경우 오류 메시지를 표시한다.(ex. 파일 다운로드에 실패했습니다. 다시 시도해 주세요.)
  • 로그 아카이브 파일이 없는 경우
    • 로그 아카이브 파일 생성 전인 경우 '아카이브 파일 없음' 안내 문구를 노출한다.
  • 로그 백업 및 아카이브 파일 생성에 실패한 경우(ex. 저장공간 없음)
    • 로그 백업 작업 및 아카이브 파일 생성에 실패한 날짜와 시간을 포함한 메시지를 표시한다.
    • 다음 백업 시도는 설정한 백업 주기에 따라 자동으로 진행될 것임을 알려준다.
      • (yyyy-mm-dd HH:MM) 로그 백업 작업 및 아카이브 파일 생성이 실패했습니다. 다음 백업 시도는 설정된 백업 주기에 따라 자동으로 진행됩니다.
  • 로그 아카이브 파일 설정 기능을 '사용 안함'으로 변경하는 경우
    • 해당 모달을 노출한다.
      • 로그 아카이브 파일 설정을 '사용 안함'으로 설정할 경우, 더 이상 로그 백업이 진행되지 않으며 아카이브 파일도 생성되지 않습니다. 로그 아카이브 파일 설정을 '사용 안함'으로 변경하시겠습니까? (취소, 사용안함)